<alarm>

Defines the alarm window.

Attributes

• w - The width of the alarm window. If not given the width is calculated automatically.
  
• h - The height of the alarm window. If not given the height is calculated automatically.
  
• threshold - This defines the alpha threshold for the region transparency. All pixels that have alpha value less than the threshold will be removed from the region.
  

Parents
skin

Children
item
category
image
month
year
calendar
eventlist
todolist
button
group
scrollgroup
time
text

<appearance>

Defines an appearance for a category or a list item.

Attributes

• target - Defines the target item(s) where the appearance is used. The possible values are: 1=Calendar, 2=EventList, 4=TodoList, 8=Alarm, 16=Tooltip. You can also combine the values by adding the numbers together. For example if you want to use the same appearance in the event and todo lists as well as in the tooltips you'd set the target to 22 (=2+4+16). This is attribute is used only in <category> element.
  
• priority - This value is used in the calendar item to define which appearance to use if the same date has multiple events. For all appearances on the same layer the one with the highest priority will be used. You can use any value (also negative). Note that also the event recurrence affects the priorities. Daily items get +10, weekly +20, monthly +30, yearly +40 and single items +50.
  
• visible - Set to 0 to hide the appearance. This does not necessarily hide the event/todo from the list.
  
• showalways - Set to 1 to draw the appearance always even if there is something with higher priority on the same layer. Appearances with showalways=1 are not included in the priority calculations at all.
  
• ignoredefault - Set to 1 to skin the default event appearance in the calendar. You can use this if you want to have the appearance on a different layer than the default event appearance and don't want it to be drawn as well.
  
• element - This defines the element to be used as appearance.
  
• align - The alignment of the element. Possible values are: "TOP-LEFT", "TOP-CENTER", "TOP-RIGHT", "CENTER-LEFT", "CENTER", "CENTER-RIGHT", "BOTTOM-LEFT", "BOTTOM-CENTER" and "BOTTOM-RIGHT".
  
• color - The color of the text. The color is defined with four (red, green, blue, alpha) comma separated values from 0 to 255 (alpha value 255 means opaque). This is only used if the element attribute refers to a font.
  
• effect - The text effect. Possible values are: "NORMAL", "BORDER" and "SHADOW". This is only used if the element attribute refers to a font.
  
• padding - This defines the space that is added around the item. The padding is defined with four (left, top, right, bottom) comma separated values which define the space in pixels for each edge.
  

Parents
cancelleditem
category
completeditem
days
events
exdays
exweekends
header
item
overdueitem
today
weekdays
weekends
weeknums

Children
None

Example

<author>

Defines the author of the skin. This is the string that is shown as the author in the skin details view in Rainlendar's options.

Attributes
None

Parents
info

Children
None

Example

<background>

Defines the background image for the tooltips. The image should define 4 frames which contain the same image in different orientations. The used frame depends on the position where the tooltip is shown (it will be rotated if it wouldn't fit on the screen).

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the element to be used as the tooltip background. The image element should have 4 frames which define the background image in all 4 different orientations.
  
• scaling - This defines how the image fills the given rectangle. Possible values are "TILE", "STRETCH", "NONE".
  

Parents
tooltip

Children
None

Example

<bitmap>

A static image that is shown in a window. Usually used to define the background of a calendar or the other windows.

Attributes

• id - Defines the identified string for the element. The items that uses this element refer to it by this string.
  
• file - This is the relative path to the image file. The file can be bmp, jpg or png format. %L can be used in the file name to substitute the current language name. If the image cannot be found the string "English" is used instead.
  
• opacity - Defines the transparency value for the image. 100 is fully opaque and 0 is completely transparent.
  

Parents
elements

Children
None

Example

<bitmapfont>

Similar as the bitmap except that the image contains a single character per frame so that it is possible to write text with the images.

Attributes

• id - Defines the identified string for the element. The items that uses this element refer to it by this string.
  
• file - This is the relative path to the image file. The file can be bmp, jpg or png format.
  
• opacity - Defines the transparency value for the image. 100 is fully opaque and 0 is completely transparent.
  
• separation - The distance in pixels between two characters. This value can be also negative.
  

Parents
elements

Children
None

Example

<button>

Draws a button to the window. The button can have three states: normal, pressed and hover. When the button is pressed the function defined with the "action" attribute is executed. The functions are defined in the lua scripts.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the element to be used as appearance. It's possible to use only image elements. The element should have 3 frames which are used as normal, pressed and hover modes.
  
• scaling - This defines how the image fills the given rectangle. Possible values are "TILE", "STRETCH", "NONE".
  
• margins - Defines the margins in the image before the stretching/tiling starts. The margins are defined with four (left, top, right, bottom) comma separated values which define the space in pixels for each edge.
  
• action - The function that is executed when the button is pressed.
  
• dblcklaction - The function that is executed when the button is double clicked.
  

Parents
alarm
cancelleditem
completeditem
group
header
item
overdueitem
scrollgroup
tooltip
window

Children
None

Example

<calendar>

Draws the calendar to the window. The calendar shows the month that the user has chosen. By default it shows the current month (unless defined otherwise with "showmonth"). This element draws all the days in the month. If only the current date should be shown use the <time> element instead.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• layout - This defines the layout of the days. Possible values are GRID, HORIZONTAL, VERTICAL and FREE.
  
• coords - If the layout is set to FREE this defines the coordinates where the days should be placed. The value must contain 62 comma separated numbers (i.e. 31 coordinate pairs).
  
• showmonth - This defines which month the calendar show show. The default value is "0" which means current month. "+1" means the next month, "+2" is the month after that and so on. Negative values mean previous months. If the + or - sign is not given the month is defined by the number (e.g. showmonth="4" means April of the current year).
  
• keeptodayinplace - If set to 1 the week which has today's date is shown first in the calendar. You can use postshowcount and preshowcount to adjust the position of the current week.
  
• postshowcount - This defines the number of weeks that are shown before the current month in the calendar. You can also use negative values. This is only used with the GRID layout.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
days
exdays
weekends
exweekends
events
today
weeknums
weekdays
category

<cancelleditem>

Defines the appearance for cancelled items. If the todo item has appearance defined by the category it might override this.

Attributes

Parents
todolist

Children
appearance
image
button

Example

<categories>

A grouping element for the categories

Attributes
None

Parents
skin

Children
category

<category>

Defines a category for which the skin has an appearance.

Attributes

Parents
alarm
calendar
categories
eventlist
todolist
tooltip

Children
appearance

Example

<comment>

A general comment or description of the skin. Here you can describe the skin instructions, functionality or whatever you feel that the user should know.

Attributes
None

Parents
info

Children
None

<completeditem>

Defines the appearance for completed items. If the todo item has appearance defined by the category it might override this.

Attributes

Parents
todolist

Children
appearance
image
button

Example

<days>

Contains an appearance which draws the normal days to the calendar. It's possible to use a normal font as the appearance's element or a bitmap font which defines alphabet from 0 to 9 or a bitmap with 32 frames (the first frame is ignored).

Attributes
None

Parents
calendar

Children
appearance

Example

<elements>

A grouping element for the skin elements. An element (not to be mistaken with an xml element) is a drawable object that is used by all items in the window. So, everything that you see in Rainlendar's windows is an element.

Attributes
None

Parents
skin

Children
bitmap
bitmapfont
font
solid
gradient

<email>

Defines the author's email. This element is optional. If defined the author is shown as a email link in the skin details view in Rainlendar's options.

Attributes
None

Parents
info

Children
None

Example

<eventlist>

Draws the event list to the window. The list contains the events from today to the user defined date. Since the height of the list cannot be known you should define the it so that the window expands automatically. Or wrap the list inside <scrollgroup> element.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
header
item
separator
category

<events>

Contains an appearance which draws a normal day with an event to the calendar. If the event's category defines a different appearance it might override this (that depends on the appearance layers and the priorities).

Attributes
None

Parents
calendar

Children
appearance

Example

<exdays>

Contains an appearance which draws the days to the calendar which do not belong to the current month. This is optional element. If not defined the days outside the current month are not drawn at all.

Attributes

• showpreexdays - Set to 1 to display the days before the current month to the calendar. The number of shown days depend on the preshowcount in the <calendar> element.
  

Parents
calendar

Children
appearance

Example

<exweekends>

Contains an appearance which draws the weekend days which do not belong to the current month. This is optional element. If not defined the <exdays> element is used instead.

Attributes
None

Parents
calendar

Children
appearance

Example

<font>

A normal font that is used to draw text.

Attributes

• id - Defines the identified string for the element. The items that uses this element refer to it by this string.
  
• size - The point size of the font.
  
• family - The family of the font. Possible values are: "DECORATIVE", "DECORATIVE", "SCRIPT", "SWISS", "MODERN", "TELETYPE" or not defined at all for the default family.
  
• style - The style of the font. Possible values are: "SLANT", "ITALIC" or not defined at all for the default style.
  
• weight - The weight of the font. Possible values are: "LIGHT", "BOLD" or not defined at all for the default weight.
  
• line - The line used in the font. Possible values are: "STRIKETHROUGH", "UNDERLINE" or not defined at all for no line.
  

Parents
elements

Children
None

Example

<gradient>

Defines a color gradient. In practice this creates a 1x256 or 256x1 size bitmap that has the color gradient. So, when using a gradient e.g. as a background for a window you should always use stretch scaling.

Attributes

• id - Defines the identified string for the element. The items that uses this element refer to it by this string.
  
• color1 - The start color of the gradient.
  
• color2 - The end color of the gradient.
  

Parents
elements

Children
None

Example

<group>

This is a grouping node for the elements. The position of the elements inside the group is relative to the group. Hiding the group will hide the contained elements too.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
image
month
year
calendar
eventlist
todolist
button
group
scrollgroup
time
text

<header>

This defines the header item for the various lists (event, todo, alarm, tooltip). The item usually displays text but it's possible to have images and buttons in it too.

Attributes

Parents
eventlist
todolist
tooltip

Children
appearance
image
button

Example

<homepage>

Defines the webpage where the users can download updated version of the skin. This element is optional.

Attributes
None

Parents
info

Children
None

Example

<image>

Draws an image to the window. If the position rectangle is larger than the size of the image it will be scaled (depends on the scaling attribute).

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the element to be used as appearance. Only image elements can be used.
  
• scaling - This defines how the image fills the given rectangle. Possible values are "TILE", "STRETCH", "NONE".
  
• frame - If the image element has multiple frames this can be used to define which one of them is shown.
  
• margins - Defines the margins in the image before the stretching/tiling starts. The margins are defined with four (left, top, right, bottom) comma separated values which define the space in pixels for each edge.
  
• minsizefromimage - If set to "1" (default) the minimum size is calculated from the image. This only applies if the size hasn't been explicitely defined. Set to "0" to let the image shrink below it's normal size.
  

Parents
alarm
cancelleditem
completeditem
group
header
item
overdueitem
scrollgroup
tooltip
window

Children
None

Example

<include>

This element can be used to split the skin definition into several files. The xml file is loaded and inserted into the place where the <include> element is defined.

Attributes

Parents
skin

Children
None

Example

<info>

This is a grouping element which contains the items that describe the skin. The contained information is shown in the skin selection dialog in the Rainlendar's options.

Attributes
None

Parents
skin

Children
version
author
email
homepage
comment
screenshot

Example

<item>

This defines a normal item for the various lists (event, todo, alarm, tooltip). The item usually displays text but it's possible to have images and buttons in it too. Buttons can use #GUID# to substitute the item's id in the parameters and #COUNT# to substitute the index of the item in the list.

Attributes

Parents
alarm
eventlist
todolist
tooltip

Children
appearance
image
button

Example

<language>

This element defines a language which will be shown in the Options->Advanced->SkinLanguage list. The purpose of this is to make it possible to use localized images in the skins. If the image element uses %L in its file attribute it is replaced by the language name selected from the settings (i.e. one defined by these <language> elements)

Attributes

Parents
languages

Children
None

Example

<languages>

A grouping element for the languages. If your skin doesn't use customized images for different languages it's not necessary to define this element.

Attributes
None

Parents
skin

Children
language

<month>

Draws the current month to the window. The displayed month changes with the user selections (e.g. from the menu or with cursor keys)

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the element to be used as appearance. It's possible to use font and image elements. The benefit from using a font is that it is localized automatically.
  
• color - The color is defined by 4 comma separated values between 0 and 255. The values are red, green, blue and alpha (i.e. transparency). Only used if the element is a font.
  
• showmonth - This defines which month the calendar show show. The default value is "0" which means current month. "+1" means the next month, "+2" is the month after that and so on. Negative values mean previous months. If the + or - sign is not given the month is defined by the number (e.g. showmonth="4" means April of the current year).
  
• align - The alignment of the element. Possible values are: "TOP-LEFT", "TOP-CENTER", "TOP-RIGHT", "CENTER-LEFT", "CENTER", "CENTER-RIGHT", "BOTTOM-LEFT", "BOTTOM-CENTER" and "BOTTOM-RIGHT".
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
None

Example

<overdueitem>

Defines the appearance for overdue items. If the todo item has appearance defined by the category it might override this.

Attributes

Parents
todolist

Children
appearance
image
button

Example

<progressbar>

Defines a progress bar that is shown in the todo items. The width of the item depends on the progress status of the task.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the image element to be used as the progress bar..
  
• scaling - This defines how the image fills the given rectangle. Possible values are "TILE", "STRETCH", "NONE".
  

Parents
todolist

Children
None

Example

<screenshot>

Defines a link to the screenshot of the skin. This element is optional. This should be a relative path to an image inside the skin package. The image is shown in the skin details view in the Rainlendar's options. Do not use too big image!

Attributes
None

Parents
info

Children
None

Example

<script>

Defines the filename of the lua script file in the skin. It's possible to execute functions only from scripts that have been defined with <script>. It's not necessary to use the <script> to define the scripts that are in the Rainlendar's own script folder just the ones that come with the skin.

Attributes

Parents
scripts

Children
None

<scripts>

A grouping element for the scripts.

Attributes
None

Parents
skin

Children
script

<scrollgroup>

This is similar grouping node as the <group>. The difference is that if the height of the elements are larger than the height of the scrollgroup a scrollbar can be used to change the view position. Only vertical scrolling is supported.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• showscrollbaraways - Set to 1 to show the scrollbar always. Normally the scrollbar is shown only when necessary.
  
• shrinktofit - Shrinks the height of the scrollgroup to fit the contents.
  
• barelement - The element that is used as the background of the scrollbar.
  
• barscaling - This defines how the bar image fills the given rectangle. Possible values are "TILE", "STRETCH", "NONE".
  
• barmargins - Defines the margins in the image before the stretching/tiling starts. The margins are defined with four (left, top, right, bottom) comma separated values which define the space in pixels for each edge.
  
• thumbelement - The element that is used as the thumb of the scrollbar. The element can have 3 frames (normal, pressed, hover)
  
• thumbscaling - Defines the margins in the image before the stretching/tiling starts. The margins are defined with four (left, top, right, bottom) comma separated values which define the space in pixels for each edge.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
image
month
year
calendar
eventlist
todolist
button
group
scrollgroup
time
text

<separator>

Defines the list separator. This is drawn between the item groups in the list.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the element to be used as appearance. Only image elements can be used.
  
• scaling - This defines how the image fills the given rectangle. Possible values are "TILE", "STRETCH", "NONE".
  
• frame - If the image element has multiple frames this can be used to define which one of them is shown.
  
• margins - Defines the margins in the image before the stretching/tiling starts. The mergins are defined with four (left, top, right, bottom) comma separated values which define the space in pixels for each edge.
  

Parents
eventlist
todolist
tooltip

Children
None

Example

<skin>

This is the root element in the skins. All other skin elements must be inside this element. You may not put anything outside the <skin>-element (except the xml header element).

Attributes

Parents
None

Children
info
variables
include
elements
scripts
categories
trayicon
languages
window
tooltip
alarm

<solid>

Defines a solid color. In practice this creates a 1x1 size bitmap that has the defined color.

Attributes

• id - Defines the identified string for the element. The items that uses this element refer to it by this string.
  

Parents
elements

Children
None

Example

<text>

Draws a static text to the window. The text is automatically translated if it can be found from the language file.

Attributes

• element - This defines the element to be used as appearance. It's possible to use font and bitmapfont elements.
  
• color - The color is defined by 4 comma separated values between 0 and 255. The values are red, green, blue and alpha (i.e. transparency). Only used if the element is a font.
  
• align - The alignment of the element. Possible values are: "TOP-LEFT", "TOP-CENTER", "TOP-RIGHT", "CENTER-LEFT", "CENTER", "CENTER-RIGHT", "BOTTOM-LEFT", "BOTTOM-CENTER" and "BOTTOM-RIGHT".
  
• effect - The text effect. Possible values are: "NORMAL", "BORDER" and "SHADOW". This is only used if the element attribute refers to a font.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
None

Example

<time>

Draws a date or time to the window. The value is updated automatically. It's also possible to draw analog clocks with this if the used element is a single image as it can be rotated by the current time.

Attributes

• element - This defines the element to be used as appearance. It's possible to use font and image elements. If a normal image is used it will be rotated around it's center (defined by cx and cy) before it's drawn on the window.
  
• color - The color is defined by 4 comma separated values between 0 and 255. The values are red, green, blue and alpha (i.e. transparency). Only used if the element is a font.
  
• align - The alignment of the element. Possible values are: "TOP-LEFT", "TOP-CENTER", "TOP-RIGHT", "CENTER-LEFT", "CENTER", "CENTER-RIGHT", "BOTTOM-LEFT", "BOTTOM-CENTER" and "BOTTOM-RIGHT".
  
• effect - The text effect. Possible values are: "NORMAL", "BORDER" and "SHADOW". This is only used if the element attribute refers to a font.
  
• format - This defines the date and time format that the <time> shows. You can use the same control codes as e.g. in the Rainlendar's TimeFormat setting (see the User Manual).
  
• timezone - Defines the timezone for the clock. You can define the timezone with the timezone code (CET, UTC, ...) or with numbers (-2, -4, +5, +7).
  
• remainder - The remainder that is taken from the value before the image is rotated. The correct values are: seconds=60, minutes=3600, hours=43200.
  
• cx - Defines the center of rotation for the image's x coordinate.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
None

Example

<today>

Contains an appearance which draws the current day to the calendar. The appearance is always drawn on the same position where the day's number is in the calendar (i.e. the position moves with the current day).

Attributes
None

Parents
calendar

Children
appearance

Example

<todolist>

Draws the task list to the window. The list contains all the user's todo items. Since the height of the list cannot be known you should define the it so that the window expands automatically. Or wrap the list inside <scrollgroup> element.

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
header
item
overdueitem
completeditem
cancelleditem
progressbar
separator
category

<tooltip>

Defines the tooltip window. The width and height of the window is calculated automatically from the background element and from the contents.

Attributes

• threshold - This defines the alpha threshold for the region transparency. All pixels that have alpha value less than the threshold will be removed from the region.
  
• offset - Defines the offset coordinates for the tooltip window.
  

Parents
skin

Children
background
separator
header
item
category
image
month
year
calendar
eventlist
todolist
button
group
scrollgroup
time
text

<trayicon>

This defines the icon that is shown in the system tray.

Attributes

Parents
skin

Children
None

Example

<variable>

Defines a variable which is shown in the skin's settings. The variables can be used to allow the user to change certain settings in the skin (hide/show items, describe time format, ...). The variables are defined per window so they can be used only inside a <window> element. The variables must be defined before they can be used which means that you should have the <variables> section before the <windows> sections.

Attributes

• name - This is the name of the variable. An underline can be used instead of a space (the underline is removed from the string displayer in the UI). When using the variable it must be enclosed inside percent signs (%).
  
• default - Defines the default value for the variable. You must always define this attribute!
  
• window - Defines the window where the variable is defined. If the same variable is used in several windows you need to create a separate <variable> element for each window. If this attribute is not defined the variable is set in all windows (and it will also show in the settings dialog for every window).
  

Parents
variables

Children
None

Example

<variables>

A grouping element for the variables. Only variable definitions are allowed inside this element.

Attributes
None

Parents
skin

Children
variable

<version>

Defines the version number of the skin. You can use any string you like. The purpose of this is to help to keep track of any changes that are done to the skin.

Attributes
None

Parents
info

Children
None

Example

<weekdays>

Contains an appearance which draws the weekdays to the calendar. This is optional element.

Attributes

Parents
calendar

Children
appearance

Example

<weekends>

Contains an appearance which draws the weekend days to the calendar. This is optional element. If not defined the <days> element is used instead.

Attributes
None

Parents
calendar

Children
appearance

Example

<weeknums>

Contains an appearance which draws the week numbers to the calendar. This is optional element.

Attributes
None

Parents
calendar

Children
appearance

Example

<window>

A window is a container for different items (calendar, eventlist, buttons, ...). The same window can contain multiple items so you can for example put several calendar elements inside the same window. It is like any other window on your desktop so you can be move it around and show/hide it.

Attributes

• id - The window's identifier. This is shown in the skin list and in the menus and it is also used in the scripts to identify the window.
  
• w - The width of the window. If not given the width is calculated automatically from the contents (if possible).
  
• h - The height of the window. If not given the height is calculated automatically from the contents (if possible).
  

Parents
skin

Children
image
month
year
calendar
eventlist
todolist
button
group
scrollgroup
time
text

<year>

Draws the current year to the window. The displayed year follows the selected date so if the user changes the month the displayed year will change too (if the month is on a different year).

Attributes

• id - This is the identifier for the item. You can use any string but it should be unique (i.e. not used by any other item)
  
• x1 - The left coordinate of the position rectangle.
  
• x2 - The right coordinate of the position rectangle.
  
• y1 - The top coordinate of the position rectangle.
  
• y2 - The bottom coordinate of the position rectangle.
  
• x - The left coordinate of the position rectangle. This is alternative to x1.
  
• y - The top coordinate of the position rectangle. This is alternative to y1.
  
• w - The width of the position rectangle.
  
• h - The height of the position rectangle.
  
• origin - The origin for x and y.
  
• origin1 - The origin for x1 and y1.
  
• origin2 - The origin for x2 and y2.
  
• visible - Set to 0 to hide the item.
  
• element - This defines the element to be used as appearance. It's possible to use font and image elements.
  
• color - The color is defined by 4 comma separated values between 0 and 255. The values are red, green, blue and alpha (i.e. transparency). Only used if the element is a font.
  
• showmonth - This defines which month the calendar show show. The default value is "0" which means current month. "+1" means the next month, "+2" is the month after that and so on. Negative values mean previous months. If the + or - sign is not given the month is defined by the number (e.g. showmonth="4" means April of the current year).
  
• align - The alignment of the element. Possible values are: "TOP-LEFT", "TOP-CENTER", "TOP-RIGHT", "CENTER-LEFT", "CENTER", "CENTER-RIGHT", "BOTTOM-LEFT", "BOTTOM-CENTER" and "BOTTOM-RIGHT".
  

Parents
alarm
group
scrollgroup
tooltip
window

Children
None

Example